﻿//AcademicPlanner - course registration planning web app.
//Copyright (C) 2009  Boubacar Diallo

//This program is free software; you can redistribute it and/or
//modify it under the terms of the GNU General Public License
//as published by the Free Software Foundation; either version 2
//of the License, or (at your option) any later version.

//This program is distributed in the hope that it will be useful,
//but WITHOUT ANY WARRANTY; without even the implied warranty of
//MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
//GNU General Public License for more details.

//You should have received a copy of the GNU General Public License
//along with this program; if not, write to the Free Software
//Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.


using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

namespace AcademicPlanner.Framework.Libraries.Auth
{
	/// <summary>
	/// Represents the result of an authorization request.
	/// </summary>
	/// <version>1.0</version>
	/// <since>1.0</since>
	public class AuthorizationResult
	{
		/// <summary>
		/// whether the authorization requested is granted or not.
		/// </summary>
		/// <version>1.0</version>
		/// <since>1.0</since>
		internal bool authorized;

		/// <summary>
		/// Gets whether the authorization requested is granted
		/// or not.
		/// </summary>
		/// <version>1.0</version>
		/// <since>1.0</since>
		public bool IsAuthorized { get { return authorized; } }
	}

	/// <summary>
	/// Provides authorization services.
	/// </summary>
	/// <version>1.0</version>
	/// <since>1.0</since>
	public interface IAuthorizer
	{
		/// <summary>
		/// Checks whether a user is authorized to perform the
		/// given operation.
		/// </summary>
		/// <param name="pUser">The user's identifier.</param>
		/// <param name="pOperation">The operation's identifier.</param>
		/// <returns>The <c>AuthorizationResult</c>.</returns>
		/// <version>1.0</version>
		/// <since>1.0</since>
		AuthorizationResult GetAuthorization(string pUser, string pOperation);

		/// <summary>
		/// Checks whether a user is authorized to perform the
		/// given operation on the given object.
		/// </summary>
		/// <param name="pUser">The user's identifier.</param>
		/// <param name="pOperation">he operation's identifier.</param>
		/// <param name="pObject">The object's identifier.</param>
		/// <returns>The <c>AuthorizationResult</c>.</returns>
		/// <version>1.0</version>
		/// <since>1.0</since>
		AuthorizationResult GetAuthorization(string pUser, string pOperation, string pObject);
	}
}
